home *** CD-ROM | disk | FTP | other *** search
/ Best of Shareware / Best of PC Windows Shareware 1.0 - Wayzata Technology (7111) (1993).iso / mac / ZIPPED / DOS / PRINTERS / TINY20.ZIP / TINY.DOC next >
Text File  |  1992-01-09  |  9KB  |  242 lines
  1. ******************************* TINY 2.0 ********************************
  2.                   Copyright (C) 1992 by Dr. S. Flitman
  3.  
  4.  
  5. PROGRAM SUMMARY:
  6.  
  7.     Tiny is a program which will print multiple files in a smaller yet
  8. still readable type on Epson and IBM Graphics printers.  Using 132 column
  9. paper and a wide-carriage Epson printer, up to six pages of text can fit
  10. on a single page of paper, a saving of over 83%!  Other modes include two
  11. columns for four filepages per page of paper (available on a standard
  12. carriage Epson and wide carriage IBM) and the default single column mode,
  13. which fits two filepages into one standard width page.  No matter which
  14. mode is used, Tiny will significantly reduce your paper consumption and
  15. thus contribute to protecting our vanishing forests.
  16.  
  17.  
  18. COMPATIBILITY:
  19.  
  20.     Tiny should work on any IBM PC with DOS 2.0 or higher.  It has
  21. only been tested with DOS 3.3 and a vast menagerie of TSRs, but it is
  22. likely not to crash on older systems.  Please address any problems to the
  23. author listed below; he will be sure to add a fix to the next version of
  24. Tiny.
  25.  
  26.  
  27. USAGE:
  28.     tiny [-option ...] filespec ...
  29.  
  30.     Options must begin with a dash '-' and precede all filespecs.  Two
  31. styles of options are permitted for those options which are single letters
  32. (take no arguments):  "-xy" or "-x -y"  Either will be properly interpreted.
  33. Option letters may be uppercase or lowercase.    
  34.     Each option is treated separately below:
  35.  
  36.  
  37.     -2            Two Columns
  38.     
  39.         Print all files in two columns.  This can be accomplished on
  40.         an Epson with only an 80 column standard carriage with, or on
  41.         an IBM with 132 column wide carriage, which requires the -w
  42.         switch as well.  Note that only 80 column long lines are
  43.         permitted in the file to be printed (longer lines will be
  44.         wrapped in the printed column); however, if printed with -w
  45.         on a wide-carriage Epson printer, 132 column lines will be
  46.         printed properly in two columns.  Note that the columns are
  47.         done newspaper style; ie, pages 1 and 2 of a file are in
  48.         the left column and pages 3 and 4 are in the right column,
  49.         continuing with the left column on the next hardcopy page.
  50.         
  51.  
  52.     -3            Three Columns
  53.     
  54.         Print all files in three columns.  This can be done only on
  55.         a wide-carriage Epson, so the -w switch must also be given
  56.         to convince Tiny that you have a wide carriage.  In this mode
  57.         six pages of a file will appear on one page of hardcopy, also
  58.         in newspaper style (see above).
  59.         
  60.  
  61.     -b            Bar
  62.     
  63.         Prints a bar (line) between all pages on a hardcopy page.
  64.         This applies to all modes, single column, two column, and
  65.         three column.
  66.         
  67.  
  68.     -i              IBM Mode
  69.     
  70.         Tells Tiny to emit printer codes specific for printers
  71.         compatible with the IBM Graphics Printer.  This leaves out
  72.         the NLQ headers (-o) and the tiny compressed elite type; in
  73.         this mode two column output cannot be achieved on an 80
  74.         column standard width carriage.
  75.         
  76.  
  77.     -n[##]            Number Lines
  78.     
  79.         Tiny will preface each line of a file with its decimal line
  80.         number, followed by a colon.  The number will always take
  81.         up four spaces, right-justified with spaces.  In the event
  82.         a file has more than 9,999 lines, the counter will turn over.
  83.         It starts at 1 unless an optional decimal number ## follows
  84.         -n without any intervening spaces.  This switch should stand
  85.         alone at the end of an option cluster.
  86.         
  87.  
  88.     -o            Old Epson Mode (No NLQ Headers)      
  89.         
  90.         Tells Tiny to use pica type for the header lines, even when
  91.         in Epson mode.  For use with older Epson printers (FX-80,
  92.         etc.) which do not support NLQ mode.
  93.         
  94.  
  95.     -p<out>         Redirect Output
  96.  
  97.         Redirects output to a file or device <out>, written directly
  98.         after the -p without any intervening spaces.  The default
  99.         output is to PRN:, which may have previously been directed
  100.         to something other than LPT1: by using DOS's MODE command.
  101.         One good use for this is to swiftly Tiny output to a file
  102.         on a ramdisk for subsequent spooling out to the printer by
  103.         DOS's PRINT program.  This switch cannot have other switches
  104.         following it as part of the same cluster (they may precede), 
  105.         so "-b2pd:out" is OK but not "-bpd:out2", because the 2 can't
  106.         be dissociated from the filename.
  107.         
  108.  
  109.     -t##            Set Tabs
  110.     
  111.         The ## following the -t without any intervening spaces must
  112.         be decimal and in the range 1-20.  This will set tab stops
  113.         every ## columns, and so permit proper expansion of tab char-
  114.         acters in the files.  It will apply to printout for all the
  115.         files on the line.  Occasionally it may produce output which
  116.         is not indented the same as when the document was displayed
  117.         or printed by your text editor or word processor; this may be
  118.         due to use of a different tab setting or different tab algor-
  119.         ithm.  If so, replace tabs with spaces so as to maintain the
  120.         appropriate indentation.  The default tab expansion is 8.
  121.         This switch can have other switches preceding it in an option
  122.         cluster, but switches following the number without a dash are
  123.         lost.
  124.  
  125.     -w              Wide
  126.     
  127.         Tells Tiny that output is intended for a 132 column (wide
  128.         carriage) printer.  Required in combination with -3 or -2
  129.         and -i (two column printout to IBM).  This redundancy is
  130.         useful for reducing erroneous hardcopy.
  131.     
  132.     
  133.     Filespecs (file specifications) are DOS filenames or paths, which
  134.     can specify drive letters and can also specify wildcards in the
  135.     terminal portion of the path (the filename.ext part).  They may be
  136.     preceded by a special prefix enclosed in braces:
  137.     
  138.         {##[-##]}filespec
  139.         
  140.     Note that this prefix must not have any intervening spaces between
  141.     it and the filespec.  Enclosed within the braces can be either one
  142.     decimal number or a range of two decimal numbers, separated by a dash.
  143.     This indicates which pages of a file to print.  If only one number
  144.     is given, it indicates the page number to begin printing with.  If
  145.     a second number is given, it indicates the page number to end print-
  146.     ing with.  Thus, a range is inclusive; both the beginning and ending
  147.     pages will be printed.  The page count is Tiny's, not the file's.
  148.     This may require printing first to a file for preview to isolate
  149.     the parts that ought to be printed.  Otherwise, Tiny's pagination
  150.     can be calculated by simple division.  If a filespec containing
  151.     wildcards matches more than one file, the prefix and its restricted
  152.     paging will apply to all of them.  The prefix applies only to the
  153.     filespec that follows, however.
  154.  
  155. EXAMPLES:
  156.  
  157.     Display options:
  158.     C:\> tiny
  159.  
  160.     Print foobar.doc in two columns, with bars (Epson, standard carriage):
  161.     C:\WP> tiny -b2 foobar.doc
  162.     
  163.     As above, but print it to a file called "spool" on D: instead of PRN:
  164.     C:\WP> tiny -b2 -pd:\spool foobar.doc                
  165.  
  166.     As above, but print it for a wider carriage printer (but for now in a
  167.     file on D:, in preparation for spooling):
  168.     C:\WP> tiny -b2 -w -pd:\spool foobar.doc
  169.  
  170.     Print all .ASM files and all .INC files to Epson, standard carriage, in
  171.     two columns without bars:
  172.     C:\386> tiny -2 *.asm *.inc
  173.  
  174.     Print all .C files to an IBM, in two columns with bars (must be wide
  175.     carriage):
  176.     C:\MSC> tiny -ib2w *.c
  177.  
  178.     As above, but set tabstops to every 5 columns:
  179.     C:\MSC> tiny -ib2w -t5 *.c
  180.  
  181.     Print pages 6 to the end of a printout that got terminated prematurely:
  182.     (Single column, Epson, without bars, standard carriage, to printer)
  183.     C:\UTL> tiny {6}prevrun.lp
  184.  
  185.     As above, but only pages 4 through 10:
  186.     C:\WP>  tiny {4-10}prevrun.lp
  187.  
  188.     For some strange reason, print only pages 1-3 of all files matching the
  189.     pattern AX???.* (and do it on an old, wide Epson with line numbers
  190.     starting with 1000 and in three columns with bars):
  191.     C:\WEIRD> tiny -o -n1000 -3b {1-3}ax???.*
  192.  
  193.  
  194. DISCLAIMER:
  195.  
  196.     I, S. Flitman, M.D. cannot be held liable for any damages, public
  197. or private, resulting from the use of this program.  It has very little
  198. potential for causing such damage, as it has been rigorously tested in
  199. several environments, and in no case has anything untoward occurred.
  200.  
  201.  
  202. REGISTRATION AND LICENSING:
  203.  
  204.     Tiny is not in the public domain.  You are granted permission by
  205. the copyright holder Dr. S. Flitman to evaluate this copy of Tiny for
  206. usefulness in your work or home setting, for thirty days.  You are welcome
  207. and encouraged to make as many copies as you wish and to distribute this
  208. package widely, so long as the contents of the original .ZIP file are
  209. maintained.  Once thirty days have elapsed, please register your copy with
  210. the author.  This costs only $10 (US) and represents payment for a license
  211. for the perpetual use of this program by you for one installation.  Please
  212. write for prices on multiple installations.  Your registration entitles you
  213. to receive free updates on disk as they come out.  Send your check or money
  214. order and your address to:
  215.  
  216.             Dr. S. Flitman
  217.             Suite 401
  218.             222 W Thomas Rd
  219.             Phoenix, AZ 85013
  220.  
  221. For an additional $10, Turbo C 2.0 source code will be sent to you on your
  222. choice of paper, 5-1/4" disk, or 3-1/2" disk.  Your money goes to support
  223. the author and his work on more exciting utilities as well as an ongoing
  224. (and very time-consuming!) project in artificial intelligence.
  225.  
  226. Thank you for using Tiny!
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.